home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / relnotes / IDF / ch1.z / ch1
Encoding:
Text File  |  2002-10-08  |  44.1 KB  |  1,319 lines
  1.  
  2.  
  3.  
  4.                                      - 1 -
  5.  
  6.  
  7.  
  8.           7.3 IRIX Development Foundation Release Notes
  9.  
  10.  
  11.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                      - 2 -
  69.  
  70.  
  71.  
  72.           1.  _I_R_I_X__D_e_v_e_l_o_p_m_e_n_t__F_o_u_n_d_a_t_i_o_n
  73.  
  74.           These release notes describe the 1.2 IRIX Development
  75.           Foundation (IDF).  The IDF is a set of four separate CDs for
  76.           IRIX 6.2, 6.3, 6.4 and 6.5, respectively.  These CDs contain
  77.           the back-ends, assembler, linkers, header files, and
  78.           libraries for the MIPSpro 7.3 compiler products.
  79.  
  80.           As of MIPSpro 7.2, the IRIS(R) Developer's Option (IDO) CD
  81.           was replaced by the IDF and IRIX(R) Development Libraries
  82.           (IDL) CD sets.  The IDL CD contains development images (such
  83.           as X and Motif headers) that are not related to the
  84.           compilers, as well as the dev subsystem which is required by
  85.           the compilers.  (For details of the IDL CD, see the IDL
  86.           release notes).
  87.  
  88.           The IDF and IDL CDs are available free of charge. This
  89.           enables developers to use the Free Software Foundation's gcc
  90.           products.
  91.  
  92.           The DBX, SpeedShop, ProDev WorkShop, and WorkShopMPF images,
  93.           previously a part of the IDF, are now in a separate
  94.           Developer's Suite CD as DBX, SpeedShop, ProDev WorkShop and
  95.           ProDev ProMP.  For more information about these tools, see
  96.           their respective release notes.
  97.  
  98.           This document contains the following sections:
  99.  
  100.             1.  Release Identification Information
  101.  
  102.             2.  Online Release Notes
  103.  
  104.             3.  Product Support
  105.  
  106.             4.  MIPSpro Compiler Products
  107.  
  108.             5.  Licensing
  109.  
  110.             6.  IDF Products
  111.  
  112.             7.  Patches for IRIX 6.2
  113.  
  114.             8.  Patches for IRIX 6.3
  115.  
  116.             9.  Patches for IRIX 6.4
  117.  
  118.            10.  Installation under the Root Directory
  119.  
  120.            11.  Modules
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                                      - 3 -
  135.  
  136.  
  137.  
  138.           1.1  _R_e_l_e_a_s_e__I_d_e_n_t_i_f_i_c_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  139.  
  140.           Following is the release identification information for the
  141.           IDF:
  142.  
  143.           Software product              IRIX Development Foundation
  144.  
  145.           Release                       1.2
  146.  
  147.           Product code                  SC4-IDEVFND-1.2
  148.  
  149.           System software requirements  IRIX 6.2 or higher
  150.  
  151.  
  152.  
  153.           1.2  _O_n_l_i_n_e__R_e_l_e_a_s_e__N_o_t_e_s
  154.  
  155.           After you install the online documentation for a product
  156.           (the relnotes subsystem), you can view the release notes on
  157.           your screen.
  158.  
  159.           If you have a graphics system, select Release Notes from the
  160.           Help submenu of the Toolchest. This displays the
  161.           grelnotes(1) graphical browser for the online release notes.
  162.           For information on options to this command, refer to the
  163.           grelnotes(1) man page.
  164.  
  165.           If you do not have a graphics system, you can use the
  166.           relnotes command.  For information on accessing the online
  167.           release notes using this command, refer to the relnotes(1)
  168.           man page.
  169.  
  170.  
  171.  
  172.           1.3  _P_r_o_d_u_c_t__S_u_p_p_o_r_t
  173.  
  174.           Silicon Graphics(R) provides a comprehensive product support
  175.           maintenance program for its products.
  176.  
  177.           If you are in the United States or Canada and would like
  178.           support for your Silicon Graphics supported products,
  179.           contact the Customer Support Center at 1-800-800-4SGI.
  180.  
  181.           If you are outside the United States or Canada, contact the
  182.           Silicon Graphics subsidiary or authorized distributor in
  183.           your country.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                      - 4 -
  201.  
  202.  
  203.  
  204.           1.4  _M_I_P_S_p_r_o__C_o_m_p_i_l_e_r__P_r_o_d_u_c_t_s
  205.  
  206.           The MIPSpro 7.3 compiler products are as follows:
  207.  
  208.              +o MIPSpro C
  209.  
  210.              +o MIPSpro C++
  211.  
  212.              +o MIPSpro Fortran 77
  213.  
  214.              +o MIPSpro Fortran 90
  215.  
  216.           Each MIPSpro compiler product comes with the following
  217.           components:
  218.  
  219.              +o A CD that contains the appropriate compiler front end
  220.  
  221.              +o IDF and IDL CD sets for IRIX 6.2, 6.3, and 6.4 (NOTE:
  222.                IDL for IRIX 6.2 6.3 and 6.4 is the same CD as in
  223.                MIPSpro 7.2.1).
  224.  
  225.              +o IDF 1.2 CD for IRIX 6.5 (the IDL for IRIX 6.5 is
  226.                packaged with IRIX 6.5)
  227.  
  228.              +o MIPSpro 7.3 Compiler Execution Environment (Compiler
  229.                EOE) CD for IRIX 6.5._x
  230.  
  231.              +o MIPSpro Developer's Suite, containing the WorkShop,
  232.                SpeedShop and ProMP tools as well as the dbx debugger.
  233.  
  234.                NOTE: The MIPSpro Auto Parallelizing Option 7.3 is a compiler
  235.                      product built into the backend of each of these products,
  236.                      but packaged with its own separate license. The MIPSpro Auto
  237.                      Parallelizing Option CD contains only release notes.
  238.  
  239.  
  240.  
  241.  
  242.           1.5  _L_i_c_e_n_s_i_n_g
  243.  
  244.           Included with the IDF 1.2 software is a Software License
  245.           Agreement.  This software is provided to you solely under
  246.           the terms and conditions of the Software License Agreement.
  247.           Please take a few moments to review the agreement.
  248.  
  249.           As of the MIPSpro 7.2 release, the MIPSpro C, C++, FORTRAN
  250.           77, Fortran 90, and Auto Parallelizing Option compiler
  251.           products come with a software license enforcement mechanism.
  252.           The IDF CDs contain version 3.2 of license_eoe (for IRIX
  253.           6.2, 6.3, and 6.4), which is recommended for use in
  254.           conjunction with the compiler products.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                      - 5 -
  267.  
  268.  
  269.  
  270.           1.6  _I_D_F__P_r_o_d_u_c_t_s
  271.  
  272.           The IDF CDs for IRIX 6.2, 6.3, and 6.4 contain the following
  273.           set of individually installable products:
  274.  
  275.           PPPPrrrroooodddduuuucccctttt               DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  276.  
  277.           c++_dev               C++ header files
  278.  
  279.           c++_eoe               C++ run-time libraries
  280.  
  281.           c_dev                 C header files
  282.  
  283.           compiler_dev          Compiler backends (required for any
  284.                                 compiler that is used)
  285.  
  286.           compiler_eoe          Compiler run-time libraries (required
  287.                                 for any compiler that is used)
  288.  
  289.           ftn77_dev             FORTRAN 77 drivers and documentation
  290.                                 (required for the FORTRAN 77 compiler)
  291.  
  292.           ftn90_dev             Fortran 90 drivers and documentation
  293.                                 (required for the  MIPSpro 7 Fortran
  294.                                 90 compiler)
  295.  
  296.           ftn_dev               Fortran archive files (required for
  297.                                 the FORTRAN 77 and MIPSpro 7 Fortran
  298.                                 90 compilers)
  299.  
  300.           ftn_eoe               FORTRAN 77 and Fortran 90 libraries
  301.                                 (required for the FORTRAN 77 and
  302.                                 MIPSpro 7  Fortran 90 compilers)
  303.  
  304.           langtools             Miscellaneous Fortran 90 language
  305.                                 tools
  306.  
  307.           license_eoe           Software licensing manager
  308.  
  309.           modules               Cray(TM) modules
  310.  
  311.           The IDF CD for IRIX 6.5 contains the same products as those
  312.           listed for IRIX 6.2, 6.3, and 6.4, except for c++_eoe,
  313.           compiler_eoe, and ftn_eoe. These subsystems are distributed
  314.           on the MIPSpro 7.3 Compiler Execution Environment for IRIX
  315.           6.5._x CDs (also known as Compiler EOE CDs).
  316.  
  317.               NOTE:  The libblas library is now installed by default.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                                      - 6 -
  333.  
  334.  
  335.  
  336.           1.7  _P_a_t_c_h_e_s__f_o_r__I_R_I_X__6_._2
  337.  
  338.           The following patches are on the IDF CD for IRIX 6.2
  339.           systems:
  340.  
  341.           patchSG0002052    Introduces the Cray explain(1) command for
  342.                             the MIPSpro 7 Fortran 90 compiler. This
  343.                             command allows users to obtain more
  344.                             information about errors reported by
  345.                             products that use the provided interfaces.
  346.                             As of this release, this list of products
  347.                             includes the MIPSpro 7 Fortran 90 compiler
  348.                             (front-end messages only).
  349.  
  350.  
  351.           patchSG0002360    gl libraries have moved from ftn_dev to
  352.                             the gl image.  The new ftn_dev is
  353.                             releasing on IRIX releases 6.2 through 6.4
  354.                             without the new gl image.  This patch
  355.                             provides the missing gl libraries for IRIX
  356.                             6.2.
  357.  
  358.  
  359.           patchSG0002813    This patch provides the 7.3 C++ compilers
  360.                             Standard Execution Environment, which is
  361.                             not shipped as part of the 7.3 compilers
  362.                             for IRIX 6.2, IRIX 6.3, and IRIX 6.4.  The
  363.                             7.3 compilers for IRIX 6.2 are shipped
  364.                             with the 6.2 Standard Execution
  365.                             Environment.  The 7.3 compilers for IRIX
  366.                             6.3 and IRIX 6.4 are shipped with the 7.1
  367.                             Standard Execution Environment.
  368.  
  369.  
  370.           patchSG0003596    This patch is a libmp rollup that contains
  371.                             libmp bugfixes for the MIPSpro 7.3
  372.                             Fortran, C, and C++ compiler development
  373.                             and execution environments. It also
  374.                             includes new OpenMP runtime support for C
  375.                             and C++.
  376.  
  377.  
  378.           patchSG0003597    This patch contains the MIPSpro 7.3
  379.                             Fortran runtime environments for IRIX
  380.                             6.2/6.3/6.4
  381.  
  382.  
  383.           patchSG0003598    This patch contains the MIPSpro 7.3 base
  384.                             compiler runtime environments for IRIX
  385.                             6.2/6.3/6.4
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                                      - 7 -
  399.  
  400.  
  401.  
  402.           1.8  _P_a_t_c_h_e_s__f_o_r__I_R_I_X__6_._3
  403.  
  404.           The following patches are on the IDF CD for IRIX 6.3
  405.           systems:
  406.  
  407.           patchSG0001892    gl libraries have moved from ftn_dev to
  408.                             the gl image.  The new ftn_dev is
  409.                             releasing on IRIX releases 6.2 through 6.4
  410.                             without the new gl image.  This patch
  411.                             provides the missing gl libraries for IRIX
  412.                             6.3 and 6.4.
  413.  
  414.  
  415.           patchSG0002052    Introduces the Cray explain(1) command for
  416.                             the MIPSpro 7 Fortran 90 compiler. This
  417.                             command allows users to obtain more
  418.                             information about errors reported by
  419.                             products that use the provided interfaces.
  420.                             As of this release, this list of products
  421.                             includes the MIPSpro 7 Fortran 90 compiler
  422.                             (front-end messages only).
  423.  
  424.  
  425.           patchSG0002813    This patch provides the 7.3 C++ compilers
  426.                             Standard Execution Environment, which is
  427.                             not shipped as part of the 7.3 compilers
  428.                             for IRIX 6.2, IRIX 6.3, and IRIX 6.4.  The
  429.                             7.3 compilers for IRIX 6.2 are shipped
  430.                             with the 6.2 Standard Execution
  431.                             Environment.  The 7.3 compilers for IRIX
  432.                             6.3 and IRIX 6.4 are shipped with the 7.1
  433.                             Standard Execution Environment.
  434.  
  435.  
  436.           patchSG0003596    This patch is a libmp rollup that contains
  437.                             libmp bugfixes for the MIPSpro 7.3
  438.                             Fortran, C, and C++ compiler development
  439.                             and execution environments. It also
  440.                             includes new OpenMP runtime support for C
  441.                             and C++.
  442.  
  443.  
  444.           patchSG0003597    This patch contains the MIPSpro 7.3
  445.                             Fortran runtime environments for IRIX
  446.                             6.2/6.3/6.4
  447.  
  448.  
  449.           patchSG0003598    This patch contains the MIPSpro 7.3 base
  450.                             compiler runtime environments for IRIX
  451.                             6.2/6.3/6.4
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                                      - 8 -
  465.  
  466.  
  467.  
  468.           1.9  _P_a_t_c_h_e_s__f_o_r__I_R_I_X__6_._4
  469.  
  470.           The following patches are on the IDF CD for IRIX 6.4
  471.           systems:
  472.  
  473.           patchSG0001892    gl libraries have moved from ftn_dev to
  474.                             the gl image.  The new ftn_dev is
  475.                             releasing on IRIX releases 6.2 through 6.4
  476.                             without the new gl image.  This patch
  477.                             provides the missing gl libraries for IRIX
  478.                             6.3 and 6.4.
  479.  
  480.  
  481.           patchSG0002052    Introduces the Cray explain(1) command for
  482.                             the MIPSpro 7 Fortran 90 compiler. This
  483.                             command allows users to obtain more
  484.                             information about errors reported by
  485.                             products that use the provided interfaces.
  486.                             As of this release, this list of products
  487.                             includes the MIPSpro 7 Fortran 90 compiler
  488.                             (front-end messages only).
  489.  
  490.  
  491.           patchSG0002813    This patch provides the 7.3 C++ compilers
  492.                             Standard Execution Environment, which is
  493.                             not shipped as part of the 7.3 compilers
  494.                             for IRIX 6.2, IRIX 6.3, and IRIX 6.4.  The
  495.                             7.3 compilers for IRIX 6.2 are shipped
  496.                             with the 6.2 Standard Execution
  497.                             Environment.  The 7.3 compilers for IRIX
  498.                             6.3 and IRIX 6.4 are shipped with the 7.1
  499.                             Standard Execution Environment.
  500.  
  501.  
  502.  
  503.           patchSG0003596    This patch is a libmp rollup that contains
  504.                             libmp bugfixes for the MIPSpro 7.3
  505.                             Fortran, C, and C++ compiler development
  506.                             and execution environments. It also
  507.                             includes new OpenMP runtime support for C
  508.                             and C++.
  509.  
  510.  
  511.           patchSG0003597    This patch contains the MIPSpro 7.3
  512.                             Fortran runtime environments for IRIX
  513.                             6.2/6.3/6.4
  514.  
  515.  
  516.           patchSG0003598    This patch contains the MIPSpro 7.3 base
  517.                             compiler runtime environments for IRIX
  518.                             6.2/6.3/6.4
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                                      - 9 -
  531.  
  532.  
  533.  
  534.           1.10  _I_n_s_t_a_l_l_a_t_i_o_n__u_n_d_e_r__t_h_e__R_o_o_t__D_i_r_e_c_t_o_r_y__(_/_)
  535.  
  536.           This section describes installation of the MIPSpro products
  537.           under the root directory (/).  The products should be
  538.           installed in the following order:
  539.  
  540.             1.  Execution environment (*_eoe subsystems):
  541.  
  542.                 For IRIX 6.2, 6.3, and 6.4, the IRIX Development
  543.                 Foundation (IDF) CDs
  544.  
  545.                 For IRIX 6.5, the MIPSpro 7.3 Compiler Execution
  546.                 Environment CD for IRIX 6.5._x (also known as the
  547.                 Compiler EOE CD)
  548.  
  549.             2.  Development subsystems (*_dev subsystems):
  550.  
  551.                 For IRIX 6.2 to 6.5, the IRIX Development Foundation
  552.                 (IDF) CDs (contain back-ends, assembler linkers,
  553.                 header files, and libraries)
  554.  
  555.                 For systems on which MIPSpro 7.2.1 was not installed,
  556.                 IRIX Development Libraries (IDL) CDs (contain the dev
  557.                 subsystem as well as development images that are not
  558.                 related to the compilers, such as X and Motif(TM)
  559.                 headers)
  560.  
  561.             3.  Front end compilers (*_fe subsystems):
  562.  
  563.                 Front end compiler CDs (contain C, C++, Fortran 90,
  564.                 and FORTRAN 77 front ends and, optionally, Auto
  565.                 Parallelizing Option (APO))
  566.  
  567.             4.  Patches or overlays
  568.  
  569.  
  570.                      NOTE:  By default, patches are not marked for installation.
  571.                             At this point you can install the patches on the IDF CD.
  572.                             Mark all patches for installation, as in the following
  573.                             example:
  574.  
  575.                                     Inst> iiiinnnnssssttttaaaallllllll ppppaaaattttcccchhhh****
  576.  
  577.                             There may be patch subsystems that are marked
  578.                             NX (not installable). To keep these subsystems
  579.                             from installing (which causes a conflict under
  580.                             inst), use the keep command.
  581.  
  582.           Installation of subsystems on the IDF 1.2 CD will remove the
  583.           MIPSpro 7.2.1 compilers (if you have them installed) unless
  584.           you use the Cray modules style installation explained in the
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                                      - 10 -
  597.  
  598.  
  599.  
  600.           section titled "Modules Installation under Alternate Root."
  601.  
  602.           The _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e and the
  603.           installation information in the _P_e_r_s_o_n_a_l _S_y_s_t_e_m
  604.           _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e fully and accurately document the
  605.           process for installing optional products.  For installation
  606.           information about a specific product, refer to that
  607.           product's online release notes.
  608.  
  609.  
  610.  
  611.           1.11  _M_o_d_u_l_e_s
  612.  
  613.           The Modules environment works in conjunction with MIPSpro
  614.           7.2 (and above) compilers installed under a location other
  615.           than the root directory (/).  This alternate location can be
  616.           on another local or remote file system.  Approximately 300
  617.           Mb of disk space is needed for an installation of one
  618.           compiler (including header files and libraries) under this
  619.           location.  The exact sizes of the compiler subsystems can be
  620.           seen under inst or software manager.
  621.  
  622.           The following images should NNNNOOOOTTTT be installed under this
  623.           alternate location:
  624.  
  625.              +o Product images, such as the InSight(TM) books and
  626.                license manager
  627.  
  628.              +o Images from the IDL CD (except for the dev subsystem)
  629.  
  630.           The DBX, SpeedShop, ProDev WorkShop, and WorkShopMPF images,
  631.           previously a part of the IDF, are now in a separate
  632.           Developer's Suite CD as DBX, SpeedShop, ProDev WorkShop and
  633.           ProDev ProMP.  These images must be installed in a different
  634.           alternate location (for more information about these tools,
  635.           see their respective release notes).
  636.  
  637.           The sequence of steps for installing and configuring modules
  638.           is described in the next section.
  639.  
  640.  
  641.           1.11.1  _M_o_d_u_l_e_s__I_n_s_t_a_l_l_a_t_i_o_n__u_n_d_e_r__A_l_t_e_r_n_a_t_e__R_o_o_t
  642.  
  643.           As a prerequisite to this installation, you must have
  644.           installed under / the *_eoe subsystems from the IRIX
  645.           Foundation CD. The dev subsystem from the IRIX Development
  646.           Libraries (IDL) CD is also required for proper compilation.
  647.  
  648.           Product images such as the InSight books, license manager,
  649.           and images (other than the dev subsystem) from the IDL CD
  650.           should not be installed under this alternate location.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                                      - 11 -
  663.  
  664.  
  665.  
  666.           The sequence of steps for installing and configuring modules
  667.           is as follows:
  668.  
  669.             1.  Install the modules system.
  670.  
  671.                 Insert the IRIX Development Foundation 1.2 CD into the
  672.                 CD-ROM drive and under inst(1) select every subsystem
  673.                 listed under modules.  The modules system gets
  674.                 installed in /opt/modules, and puts some of its data
  675.                 files in /opt/modulefiles, as in the following
  676.                 example:
  677.  
  678.                 # iiiinnnnsssstttt ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt
  679.  
  680.                 Inst> kkkkeeeeeeeepppp ****
  681.                 Inst> iiiinnnnssssttttaaaallllllll mmmmoooodddduuuulllleeeessss
  682.                 Inst> ggggoooo
  683.  
  684.                  (_I_n_s_t_a_l_l_a_t_i_o_n _o_c_c_u_r_s)
  685.  
  686.                 Inst> qqqquuuuiiiitttt
  687.  
  688.  
  689.                 At this point, there will be useful documentation
  690.                 about modules in the following locations:
  691.  
  692.                 /opt/MIPSpro/admin                 A description of
  693.                                                    the format of
  694.                                                    modulefiles
  695.  
  696.                 /opt/modules/modules/man           Man pages for the
  697.                                                    modules command
  698.  
  699.                 /opt/modules/modules/doc/Modules-Paper.ps An old
  700.                                                    USENIX LISA paper
  701.                                                    about the
  702.                                                    motivation behind
  703.                                                    and basic design of
  704.                                                    modules
  705.  
  706.                      NOTE: The /opt/modules/modules/README file discusses
  707.                            the installation of the freeware version of modules
  708.                            and is not very relevant to the Silicon Graphics
  709.                            distribution of modules.
  710.  
  711.             2.  Create the directory in which you want to install the
  712.                 compilers and make a symbolic link to it, as in the
  713.                 following example:
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                                      - 12 -
  729.  
  730.  
  731.  
  732.                 # mmmmkkkkddddiiiirrrr ////ddddiiiisssskkkk6666////mmmmoooonnnnggggoooooooosssseeee////7777....3333
  733.                 # llllnnnn ----ssss ////ddddiiiisssskkkk6666////mmmmoooonnnnggggoooooooosssseeee////7777....3333 ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333
  734.  
  735.             3.  Install the 7.3 MIPSpro compiler run-time libraries
  736.                 under the alternate root.
  737.  
  738.  
  739.                      NOTE: The following example assumes that you already have
  740.                            an earlier version of MIPSpro compilers installed
  741.                            under / and that the dev subsystem from the
  742.                            IRIX Development Libraries (IDL) CD is installed.
  743.  
  744.  
  745.                 For IRIX 6.2, 6.3, and 6.4, install the IRIX
  746.                 Development Foundation CD first.  For IRIX 6.5,
  747.                 install the MIPSpro 7.3 Compiler Execution Environment
  748.                 for IRIX 6.5._x CD (also known as Compiler EOE CD)
  749.                 first.
  750.  
  751.                 For IRIX 6.2, 6.3, and 6.4, compiler_eoe, c++_eoe and
  752.                 ftn_eoe are on the IRIX Development Foundation CD.  To
  753.                 install them, use the following procedure:
  754.  
  755.                 With the IRIX Development Foundation CD inserted,
  756.                 enter the following commands:
  757.  
  758.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt          (on IRIX 6.2)
  759.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....3333  (on IRIX 6.3)
  760.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....4444  (on IRIX 6.4)
  761.  
  762.                      NOTE: /opt/MIPSpro/73 is the installation directory
  763.                            for the released version.  /CDROM/dist,
  764.                            /CDROM/dist/dist6.3, and /CDROM/dist/dist6.4
  765.                            are the locations of the distribution images for IRIX 6.2,
  766.                            6.3, and 6.4, respectively.
  767.  
  768.                 Inst> kkkkeeeeeeeepppp ****
  769.                 Reading installation history .. 100% Done.
  770.                 Reading distribution .. 100% Done.
  771.                 Checking dependencies .. 100% Done.
  772.                 Calculating sizes .. 100% Done.
  773.  
  774.                 Inst> iiiinnnnssssttttaaaallllllll ccccoooommmmppppiiiilllleeeerrrr____eeeeooooeeee cccc++++++++____eeeeooooeeee ffffttttnnnn____eeeeooooeeee
  775.  
  776.                 Inst> ggggoooo
  777.                 Pre-installation check .. 100% Done.
  778.                 Installing/removing software ...
  779.  
  780.  
  781.                 For IRIX 6.5, compiler_eoe, c++_eoe, and ftn_eoe are
  782.                 on the Compiler EOE CD. To install them, use the
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                      - 13 -
  795.  
  796.  
  797.  
  798.                 following procedure.
  799.  
  800.                 For IRIX 6.5, the 7.2.1 version of compiler_eoe,
  801.                 c++_eoe, and ftn_eoe is required to upgrade to 7.3.
  802.                 For your convenience, the images are located on the
  803.                 7.3 Compiler EOE CD.
  804.  
  805.                 With the Compiler EOE CD inserted, enter the
  806.                 following:
  807.  
  808.  
  809.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt____mmmmoooodddduuuulllleeeessss
  810.  
  811.                      NOTE: inst gives warnings about Preference
  812.                            "overlay_mode" and "stream" ignored.
  813.  
  814.                 Inst> kkkkeeeeeeeepppp ****
  815.  
  816.                 Inst> iiiinnnnssssttttaaaallllllll  ccccoooommmmppppiiiilllleeeerrrr____eeeeooooeeee cccc++++++++____eeeeooooeeee ffffttttnnnn____eeeeooooeeee
  817.  
  818.                 Inst> sssseeeetttt rrrruuuulllleeeessssoooovvvveeeerrrrrrrriiiiddddeeee ttttrrrruuuueeee
  819.  
  820.                 Inst> ggggoooo
  821.                 Pre-installation check .. 100% Done.
  822.                 Installing/removing software ...
  823.  
  824.  
  825.                 With the Compiler EOE CD inserted, enter the
  826.                 following:
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.                                      - 14 -
  861.  
  862.  
  863.  
  864.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....5555  (on IRIX 6.5)
  865.  
  866.                      NOTE: inst gives warnings about Preference
  867.                            "overlay_mode" and "stream" ignored.
  868.  
  869.                 Inst> kkkkeeeeeeeepppp ****
  870.                 Reading product descriptions ..  63%
  871.  
  872.                 Select appropriate software stream to install.
  873.                 -------------------------------------------------
  874.                 Before you install an intermediate release, you must
  875.                 select between two streams of installable software:
  876.                 the maintenance stream, which contains accumulated
  877.                 bug fixes and any required software for new hardware
  878.                 components; or the feature stream, which contains
  879.                 accumulated bug fixes, any required software for new
  880.                 hardware components, and new hardware and software
  881.                 features.  After your selection, inst automatically
  882.                 identifies the modules in the stream that you selected
  883.                 and loads them with no further prompting.  The
  884.                 currently loaded distributions contain maintenance
  885.                 and feature stream products.
  886.  
  887.                 Select the maintenance stream if you simply want
  888.                 to maintain the current hardware and software
  889.                 functions on your system.  The maintenance stream
  890.                 insures compatibility of new hardware components.
  891.  
  892.                 Select the feature stream if you want to upgrade
  893.                 hardware and software with new features.  Occasionally,
  894.                 the feature stream introduces incompatibilities between
  895.                 old and new hardware components.
  896.  
  897.                 To change the stream selection between maintenance
  898.                 and feature, reset the stream preference to the new
  899.                 setting.  In some cases, resetting the stream
  900.                 preference and installing products from the new
  901.                 stream requires reinstalling portions of the IRIX
  902.                 operating system.
  903.                 -------------------------------------------------
  904.                 1. Place me on the maintenance stream.
  905.                 2. Place me on the feature stream.
  906.                 3. Cancel
  907.                 Please enter a choice [1]: <<<<RRRREEEETTTTUUUURRRRNNNN>>>> <---- enter <RETURN>
  908.  
  909.                 Inst> kkkkeeeeeeeepppp ****
  910.                 Reading product descriptions .. 100% Done.
  911.  
  912.                 Since the compiler_eoe, c++_eoe and ftn_eoe images
  913.                 are bundled with all of the other IRIX  eoe images that are
  914.                 required for installation under root (/), inst might flag these
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                                      - 15 -
  927.  
  928.  
  929.  
  930.                 other subsystems as required and cause a conflict.  To work around
  931.                 these potential conflicts, use the following procedure:
  932.  
  933.                 Inst> sssseeeetttt rrrruuuulllleeeessssoooovvvveeeerrrrrrrriiiiddddeeee ttttrrrruuuueeee
  934.  
  935.                 Then install the compiler EOE subsystems, as follows:
  936.  
  937.                 Inst> iiiinnnnssssttttaaaallllllll ccccoooommmmppppiiiilllleeeerrrr____eeeeooooeeee cccc++++++++____eeeeooooeeee ffffttttnnnn____eeeeooooeeee
  938.  
  939.                 Inst> ggggoooo
  940.                 Pre-installation check .. 100% Done.
  941.                 Installing/removing software ...
  942.  
  943.                 Inst> qqqquuuuiiiitttt
  944.  
  945.  
  946.  
  947.                      NOTE: Please ignore the following message displayed
  948.                            when exiting inst:
  949.  
  950.                             "ERROR: INCOMPATIBLE SUBSYSTEMS INSTALLED."
  951.  
  952.  
  953.                 On IRIX 6.5 and 6.5.1, the version of the images will
  954.                 still show as 7.2.1, as follows:
  955.  
  956.                 # vvvveeeerrrrssssiiiioooonnnnssss ----nnnn ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333
  957.                 I c++_eoe        1275390910     Standard Execution Environment
  958.                 (C++ Headers and Libraries, 7.2.1)
  959.  
  960.             4.  Install the compiler subsystems on the IRIX
  961.                 Development Foundation (IDF) CD under the alternate
  962.                 root.
  963.  
  964.                 When installing from the IDF CD with inst -r for use
  965.                 with the modules utility, the location of the
  966.                 distribution must be specified as follows:
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.                                      - 16 -
  993.  
  994.  
  995.  
  996.                 With the appropriate IDF CD inserted, type the following commands:
  997.  
  998.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt          (on IRIX 6.2)
  999.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....3333  (on IRIX 6.3)
  1000.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....4444  (on IRIX 6.4)
  1001.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....5555  (on IRIX 6.5)
  1002.  
  1003.                      NOTE: /opt/MIPSpro/73 is the installation
  1004.                            directory for the released version.
  1005.                            /CDROM/dist, /CDROM/dist/dist6.3,
  1006.                            /CDROM/dist/dist6.4, and /CDROM/dist/dist6.5
  1007.                            are the locations of the distribution images for
  1008.                            IRIX 6.2, 6.3, 6.4, and 6.5, respectively.
  1009.  
  1010.  
  1011.                 As mentioned previously, the InSight books and
  1012.                 license_eoe should not be installed under the
  1013.                 alternate location. You can do this under inst, as
  1014.                 follows:
  1015.  
  1016.                 Inst> kkkkeeeeeeeepppp ****....bbbbooooooookkkkssss....**** lllliiiicccceeeennnnsssseeee____eeeeooooeeee
  1017.  
  1018.                 compiler_dev.sw.base requires the dev subsystem to be
  1019.                 present in the alternate root.  To avoid the conflict
  1020.                 when dev is not installed under the alternate root,
  1021.                 enter the following:
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.                                      - 17 -
  1059.  
  1060.  
  1061.  
  1062.                 Inst> sssseeeetttt rrrruuuulllleeeessssoooovvvveeeerrrrrrrriiiiddddeeee ttttrrrruuuueeee
  1063.  
  1064.                      NOTE: By default, patches are not marked for
  1065.                            installation. At this point you can install
  1066.                            the patches on the IDF CD. Mark all patches
  1067.                            for installation, as in the following example:
  1068.  
  1069.                                  Inst> iiiinnnnssssttttaaaallllllll ppppaaaattttcccchhhh****
  1070.  
  1071.                            There may be patch subsystems that are marked
  1072.                            NX (not installable). To keep these
  1073.                            subsystems from installing (which causes a
  1074.                            conflict under inst), use the keep
  1075.                            command.
  1076.  
  1077.  
  1078.                 Inst> ggggoooo
  1079.                 Pre-installation check .. 100% Done.
  1080.                 Installing/removing software ...
  1081.  
  1082.                 Inst> qqqquuuuiiiitttt
  1083.  
  1084.                      NOTE: Please ignore the following message displayed
  1085.                            when exiting inst:
  1086.  
  1087.                             "ERROR: INCOMPATIBLE SUBSYSTEMS INSTALLED."
  1088.  
  1089.             5.  Install the compiler front ends from the MIPSpro 7.3
  1090.                 compiler CDs.
  1091.  
  1092.                 This step is repeated for each compiler language and
  1093.                 is similar to step 4, except that the installation is
  1094.                 from the MIPSpro 7.3 compiler CDs.  For example:
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.                                      - 18 -
  1125.  
  1126.  
  1127.  
  1128.                 With the appropriate MIPSpro 7.3 C Compiler CD inserted, type the following
  1129.                 commands:
  1130.  
  1131.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt          (on IRIX 6.2)
  1132.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....3333  (on IRIX 6.3)
  1133.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....4444  (on IRIX 6.4)
  1134.                 # iiiinnnnsssstttt ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333 ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////ddddiiiisssstttt6666....5555  (on IRIX 6.5)
  1135.  
  1136.                      NOTE: The MIPSpro Auto Parallelizing Option 7.3
  1137.                            CD contains only release notes. The man page
  1138.                            is packaged in compiler_dev.man.base.
  1139.                            The main component of the product is the
  1140.                            license that enables automatic parallelization.
  1141.  
  1142.                            As mentioned previously, InSight books
  1143.                            subsystems are not to be installed under
  1144.                            a modules installation. Use the keep
  1145.                            command ( Inst> keep *.books.* )
  1146.                            to prevent them from being installed.
  1147.  
  1148.                 Inst> ggggoooo
  1149.                 Pre-installation check .. 100% Done.
  1150.                 Installing/removing software ...
  1151.  
  1152.                 Inst> qqqquuuuiiiitttt
  1153.  
  1154.                      NOTE: Please ignore the following message
  1155.                            displayed when exiting inst:
  1156.  
  1157.                             ERROR: INCOMPATIBLE SUBSYSTEMS INSTALLED.
  1158.  
  1159.                 On IRIX 6.5 and 6.5.1, the version of the images will still show as 7.2.1,
  1160.                 as follows:
  1161.  
  1162.                 # vvvveeeerrrrssssiiiioooonnnnssss ----nnnn ----rrrr ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333
  1163.                 I c++_eoe        1275390910    Standard Execution Environment
  1164.                 (C++ Headers and Libraries, 7.2.1)
  1165.  
  1166.  
  1167.                 You now have everything that you need installed under
  1168.                 the alternate root.  You can view the various release
  1169.                 notes of the subsystems that you installed by setting
  1170.                 the RELNOTESPATH environment variable to the
  1171.                 usr/relnotes directory relative to the alternate root,
  1172.                 as in the following example:
  1173.  
  1174.                 % sssseeeetttteeeennnnvvvv RRRREEEELLLLNNNNOOOOTTTTEEEESSSSPPPPAAAATTTTHHHH ////oooopppptttt////MMMMIIIIPPPPSSSSpppprrrroooo////77773333////uuuussssrrrr////rrrreeeellllnnnnooootttteeeessss
  1175.                 % rrrreeeellllnnnnooootttteeeessss
  1176.  
  1177.                    (_L_i_s_t _o_f _i_n_s_t_a_l_l_e_d _s_u_b_s_y_s_t_e_m_s _i_s _o_u_t_p_u_t.)
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                                      - 19 -
  1191.  
  1192.  
  1193.  
  1194.             6.  Create modulefiles for 7.3, as follows:
  1195.  
  1196.  
  1197.                 # ccccdddd ////oooopppptttt////mmmmoooodddduuuulllleeeeffffiiiilllleeeessss
  1198.                 # ccccpppp MMMMIIIIPPPPSSSSpppprrrroooo MMMMIIIIPPPPSSSSpppprrrroooo....77773333
  1199.  
  1200.  
  1201.                 Edit the MIPSpro.73 file so that the MIPSPRO_SGI and
  1202.                 MIPSPRO_LEVEL variables point to the installation of
  1203.                 the 7.3 compilers. The file contains documentation
  1204.                 about this.  If you have the 7.3 compilers installed
  1205.                 in the root directory (/), you can set these variables
  1206.                 as follows:
  1207.  
  1208.                 # sssseeeetttt MMMMIIIIPPPPSSSSPPPPRRRROOOO____LLLLEEEEVVVVEEEELLLL       """"""""
  1209.                 # sssseeeetttt MMMMIIIIPPPPSSSSPPPPRRRROOOO____SSSSGGGGIIII         ////
  1210.  
  1211.                 This will produce paths that look like //bin, but work
  1212.                 just fine.
  1213.  
  1214.  
  1215.             7.  Put commands to use modules into user's .cshrc (or
  1216.                  .profile, etc.) shell initialization files, as
  1217.                 follows:
  1218.  
  1219.  
  1220.                 % ssssoooouuuurrrrcccceeee ////oooopppptttt////mmmmoooodddduuuulllleeeessss////mmmmoooodddduuuulllleeeessss////iiiinnnniiiitttt////ccccsssshhhh
  1221.                    (or .... ////oooopppptttt////mmmmoooodddduuuulllleeeessss////mmmmoooodddduuuulllleeeessss////iiiinnnniiiitttt////kkkksssshhhh ((((sssshhhh)))), etc.)
  1222.                 % mmmmoooodddduuuulllleeee llllooooaaaadddd mmmmoooodddduuuulllleeeessss
  1223.                 % mmmmoooodddduuuulllleeee llllooooaaaadddd MMMMIIIIPPPPSSSSpppprrrroooo....77773333
  1224.  
  1225.  
  1226.                 The first module load command loads the module(1)
  1227.                 command itself into the environment.  The second
  1228.                 module load loads the compiler.  In the case of the
  1229.                 MIPSpro compilers, executing a module load performs
  1230.                 such actions as adding the compiler binaries to PATH,
  1231.                 adding the man page directories to MANPATH, setting up
  1232.                 ROOT and TOOLROOT, and adding paths to shared
  1233.                 libraries and dynamically loaded objects to
  1234.                 LD_LIBRARY_PATH. RLD_PATH also gets changed.
  1235.  
  1236.  
  1237.             8.  To swap from the version 7.2.1 compiler to the 7.3
  1238.                 version, the user can execute the following command:
  1239.  
  1240.  
  1241.                 % mmmmoooodddduuuulllleeee sssswwwwaaaapppp MMMMIIIIPPPPSSSSpppprrrroooo....777722221111 MMMMIIIIPPPPSSSSpppprrrroooo....77773333
  1242.  
  1243.  
  1244.                 The module swap command makes all the necessary
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.                                      - 20 -
  1257.  
  1258.  
  1259.  
  1260.                 changes to the environment, such as replacing the path
  1261.                 to the compiler binaries.
  1262.  
  1263.           For more information about modules, after installing the
  1264.           modules images, refer to the modules release notes, the
  1265.           modules(1) man page, and /opt/modules/2.2.1/doc/Modules-
  1266.           Paper.ps.
  1267.  
  1268.           You can test which version you are running by using the
  1269.           following command:
  1270.  
  1271.           % cccccccc ----nnnn33332222 ----vvvveeeerrrrssssiiiioooonnnn ffffoooooooo....cccc
  1272.  
  1273.           Output such as the following indicates that you are running
  1274.           version 7.3:
  1275.  
  1276.           MIPSpro Compilers: Version 7.30
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.